home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / dog303.arc / DOG.DOC < prev    next >
Text File  |  1991-03-19  |  42KB  |  1,142 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                          Disk OrGanizer - Version 3.03
  19.                                  March 19, 1991
  20.  
  21.                               Soft GAM's Software
  22.                               G. Allen Morris III
  23.                                  P. O. Box 1311
  24.                               Mendocino, CA  95460
  25.  
  26.                                  Copyright 1991
  27.                               All Rights Reserved
  28.  
  29.                             Compuserve: #73210,3374
  30.                               Voice: (707)961-1632
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                               _______
  38.                          ____|__     |               (tm)
  39.                       --|       |    |-------------------
  40.                         |   ____|__  |  Association of
  41.                         |  |       |_|  Shareware
  42.                         |__|   o   |    Professionals
  43.                       -----|   |   |---------------------
  44.                            |___|___|    MEMBER
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                Table of Contents
  51.  
  52.  
  53.  
  54.  
  55.         1. Getting started ........................................... 1
  56.         1.1. Introduction ............................................ 1
  57.         1.2. Shareware ............................................... 1
  58.         1.3. Purpose ................................................. 1
  59.         1.4. Installation ............................................ 1
  60.         1.5. Background programs ..................................... 2
  61.         1.6. Copy protected programs ................................. 3
  62.         1.7. Power failure ........................................... 3
  63.         1.8. Quick start ............................................. 3
  64.  
  65.         2. Using Disk OrGanizer ...................................... 5
  66.         2.1. Modes ................................................... 5
  67.         2.2. Switches ................................................ 6
  68.         2.3. Command line syntax ..................................... 6
  69.         2.3.1. Command line commands ................................. 7
  70.         2.4. Orderfile syntax ........................................ 7
  71.         2.4.1. Setting the mode ...................................... 7
  72.         2.4.2. Setting switches ...................................... 8
  73.         2.4.3. Order file Commands ................................... 8
  74.         2.4.4. File identifiers ..................................... 10
  75.         2.4.5. Comments ............................................. 10
  76.  
  77.         3. Licensing and support. ................................... 11
  78.         3.1. Copyright/License/Warranty ............................. 11
  79.         3.2. Licensing .............................................. 11
  80.         3.3. Technical Support ...................................... 12
  81.         3.4. ASP Ombudsman Information .............................. 12
  82.  
  83.         4. Error messages ........................................... 13
  84.  
  85.         5. Glossary ................................................. 16
  86.  
  87.         6. Index .................................................... 17
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                                       i
  104.  
  105.      1. Getting started
  106.      ----------------------------------------------------------------------
  107.      1.1. Introduction
  108.  
  109.  
  110.         1.1. Introduction
  111.  
  112.         Hello  and  thank you for taking the time to read this manual. I
  113.         hope that you find Disk OrGanizer useful.
  114.  
  115.         1.2. Shareware
  116.  
  117.         Disk OrGanizer is not a public domain program.  Copies  of  Disk
  118.         OrGanizer  for  personal  use  are  free,  but  if you find Disk
  119.         OrGanizer of value, you are  encouraged  to  make  a  gift  ($20
  120.         suggested)  and  become a Disk OrGanizer supporter. You may also
  121.         register your copy of Disk OrGanizer for $30 and receive a  disk
  122.         and  manual  along  with  notification  of  future  versions.  A
  123.         license is required for use of Disk  OrGanizer  by  corporations
  124.         and institutions, and for its commercial distribution.
  125.  
  126.         If you don't support shareware it will go away.
  127.  
  128.         1.3. Purpose
  129.  
  130.         A  disk  that has been in use a while will usually become slower
  131.         accessing the data and programs that have  been  stored  on  it.
  132.         This is due to two problems:
  133.  
  134.          o  The disk has become fragmented.
  135.          o  There are deleted entries in directories.
  136.  
  137.         Disk  OrGanizer will solve these problems and make your disk run
  138.         like new.
  139.  
  140.         If the size of a directory decreases enough after  removing  the
  141.         deleted entries Disk OrGanizer can also recover some disk space.
  142.  
  143.         Disk  OrGanizer  has  been  tested with MS-DOS 2.10, 3.01, 3.10,
  144.         3.30, 4.01 and 5.0 on logical drives as large as 600  megabytes.
  145.         It is believed that Disk OrGanizer will operate on any MS/PC-DOS
  146.         disk.
  147.  
  148.         Disk OrGanizer performs extensive tests before it starts to move
  149.         data,  to  make  sure  that  the File Allocation Table (FAT) and
  150.         directories are in good repair.
  151.  
  152.         1.4. Installation
  153.  
  154.         You should BACK UP your hard disk before you run Disk OrGanizer.
  155.  
  156.         To install Disk OrGanizer, you need only copy it to a  directory
  157.         on your PATH.
  158.  
  159.         You can test Disk OrGanizer by typing the command:
  160.  
  161.              DOG [d:] /TEST
  162.  
  163.  
  164.      Disk OrGanizer                                                       1
  165.  
  166.      1. Getting started
  167.      ----------------------------------------------------------------------
  168.      1.4. Installation
  169.  
  170.  
  171.  
  172.         d:  is  an optional drive specifier. (The []'s mean optional and
  173.         should not be typed.) If no drive is specified the current drive
  174.         will be used.
  175.  
  176.         If  Disk  OrGanizer  reports  errors  and  you have not run Disk
  177.         OrGanizer before, you should run CHKDSK with the /F  switch  and
  178.         repair the disk.
  179.  
  180.         If you have not backed up your disk Disk OrGanizer will warn you
  181.         as to how many files may need to be backed up.
  182.  
  183.         PLEASE back up your disks before you run Disk OrGanizer.
  184.  
  185.         Disk OrGanizer will also list any files that are open on on  the
  186.         disk that you are organizing. Disk OrGanizer will not be able to
  187.         move these files nor pack the directories that they are in.
  188.  
  189.         If you have used other disk defragment programs before, and have
  190.         had no problem, it should be safe to run Disk OrGanizer.
  191.  
  192.         Disk  OrGanizer will move HIDDEN files,  most other disk defrag-
  193.         menters don't move these files.
  194.  
  195.         If you have not run any  disk  defragment  programs  before  you
  196.         should read the rest of this chapter.
  197.  
  198.         1.5. Background programs
  199.  
  200.         Disk  OrGanizer reads and writes to the disk directly. If a pro-
  201.         gram tries  to  write  to  the  disk  while  Disk  OrGanizer  is
  202.         operating,  data  may be lost. You should not run Disk OrGanizer
  203.         on a disk that you know will be written to.  Programs  that  are
  204.         likely  to  write to the disk are printer spoolers, multitasking
  205.         programs like Windows or DesqView, switching programs  and  net-
  206.         work programs.
  207.  
  208.         If you have FASTOPEN installed on your computer you will need to
  209.         reboot your computer after you run Disk OrGanizer.
  210.  
  211.         Some background programs leave files open all of the time.  Disk
  212.         OrGanizer will not move files that are open and it will not pack
  213.         a directory that has open files in it.
  214.  
  215.         If you do not know if you have these programs on your computer I
  216.         would  suggest that you run Disk OrGanizer from a floppy disk as
  217.         described in the Quick Start section.
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.      Disk OrGanizer                                                       2
  226.  
  227.      1. Getting started
  228.      ----------------------------------------------------------------------
  229.      1.6. Copy protected programs
  230.  
  231.  
  232.         1.6. Copy protected programs
  233.  
  234.         Disk OrGanizer may make some copy protected software unusable.
  235.  
  236.         It is recommended that you remove any  copy  protected  software
  237.         from  your  disk  before  you  run  Disk OrGanizer, if you can't
  238.         determine its compatibility with Disk OrGanizer.
  239.  
  240.         1.7. Power failure
  241.  
  242.         Disk OrGanizer can recover from a power failure or reboot.
  243.  
  244.         If a power failure  or  inadvertent  reboot  occurs  while  Disk
  245.         OrGanizer is running you should run Disk OrGanizer again as soon
  246.         as possible. Disk OrGanizer will report any errors that it finds
  247.         on the disk and ask you if you would like to repair them. If you
  248.         answer yes to all of the questions Disk  OrGanizer  will  repair
  249.         the disk and then continue operation as normal.
  250.  
  251.         You  should  not  use  any third party CHKDSK type programs that
  252.         recover lost clusters.  If you use CHKDSK you  should  NOT  make
  253.         the lost cluster chains into files.
  254.  
  255.         1.8. Quick start
  256.  
  257.         If  you  would like to defragment your disk and get back to work
  258.         without having to read the rest of this manual the simplest  and
  259.         safest way to run Disk OrGanizer is described here.
  260.  
  261.         The  first  thing to do is to find an old or unused floppy disk.
  262.         Then format this disk with a copy of the system.
  263.  
  264.              FORMAT A: /sys
  265.  
  266.         Copy DOG.EXE to the floppy disk.
  267.  
  268.              COPY DOG.EXE A:
  269.  
  270.         You may need to create or copy CONFIG.SYS on the new disk if you
  271.         have  disk  drivers  or  an  EMS  memory driver that needs to be
  272.         installed.
  273.  
  274.         Reboot your computer (Ctrl-Alt-Delete) with  the  new  disk  in-
  275.         stalled in the A: drive.
  276.  
  277.         DOS will ask you for the date and time. This is because there is
  278.         no AUTOEXEC.BAT file.  Enter the correct date and time.
  279.  
  280.         Run Disk OrGanizer on your hard disk.
  281.  
  282.              DOG C: /AUTO /CRC /TRUNCATE
  283.  
  284.  
  285.  
  286.      Disk OrGanizer                                                       3
  287.  
  288.      1. Getting started
  289.      ----------------------------------------------------------------------
  290.      1.8. Quick start
  291.  
  292.  
  293.  
  294.         Disk OrGanizer will test the disk  (like  CHKDSK),  give  you  a
  295.         report, analyze the disk to determine the best place to have the
  296.         directories and files on the disk. Tell you how many directories
  297.         need  to  have deleted files removed (packed), tell you how many
  298.         directories can be made shorter (truncated)  and  tell  you  the
  299.         number  of  clusters that it will have to move to defragment the
  300.         files and directories on the disk.
  301.  
  302.         You will then be asked if it is OK to write to the disk. If  you
  303.         answer  no  to  this  question, Disk OrGanizer will quit without
  304.         ever having written  to  the  disk.  If  you  answer  yes,  Disk
  305.         OrGanizer  will  pack  the directories, truncate the directories
  306.         and then start moving clusters.
  307.  
  308.         While Disk OrGanizer is moving clusters you will  see  the  fol-
  309.         lowing message:
  310.  
  311.              X nnnnn - elapsed time  0:00:00  estimated 0:00:00
  312.  
  313.         X  is  either  R)eading,  S)orting,  C)omputing  CRC,  W)riting,
  314.         T)esting  CRC,  L)inking  new  clusters  or  U)pdating  FAT  and
  315.         directories.  nnnnn  is  the  number  of clusters that have been
  316.         moved. Elapsed time is the amount of  time  Disk  OrGanizer  has
  317.         been  moving clusters and estimated is the approximate amount of
  318.         time it will take to organize the disk.
  319.  
  320.         You can quit from Disk OrGanizer at anytime by pressing the  es-
  321.         cape  (Esc)  key  or  a  ^C. Stopping Disk OrGanizer while it is
  322.         moving clusters may  cause  extreme  fragmentation,  rerun  Disk
  323.         OrGanizer  as  soon  as possible if you abort while it is moving
  324.         clusters.
  325.  
  326.         If you think that Disk OrGanizer has stopped running, press  the
  327.         space bar, you should then hear a beep within a few seconds.
  328.  
  329.         When  it  is  done it will check the disk once again, give you a
  330.         new report and then exit.
  331.  
  332.         You should then remove the floppy disk from  the  A:  drive  and
  333.         reboot your computer.
  334.  
  335.         You  should  notice that the programs on your disk load a little
  336.         faster. If Disk OrGanizer truncated some  directories  you  will
  337.         also have more free disk space.
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.      Disk OrGanizer                                                       4
  348.  
  349.      2. Using Disk OrGanizer
  350.      ----------------------------------------------------------------------
  351.  
  352.  
  353.         The purpose of Disk OrGanizer is to speed up the access of files
  354.         on  your  disks.   There are two things that slow down access of
  355.         data; deleted files in directories and fragmented  files.    The
  356.         actual  placement  of files on a disk has very little to do with
  357.         the amount of time it takes to load a file.  Most  disk  defrag-
  358.         ment programs take a long time to run and this keeps people from
  359.         running them often.
  360.  
  361.         Disk OrGanizer has complex algorithms that allow it  to  defrag-
  362.         ment  all of the files on a disk while moving very few clusters.
  363.         Although Disk OrGanizer can control the placement of  files  and
  364.         directories  on  the disk, I would suggest that you refrain from
  365.         using this feature, as it can greatly  increase  the  number  of
  366.         clusters that Disk OrGanizer will need to move and give you very
  367.         little benefit. The exception to this are dirctrories  that  are
  368.         read  often,  such as the directories on the PATH, which you may
  369.         want to move near  the  File  Allocation  Table  (see  the  AUTO
  370.         command.)
  371.  
  372.         2.1. Modes
  373.  
  374.         The mode determines how Disk OrGanizer will organize a disk.
  375.  
  376.         FILL -  mode  will defragment files and put them as close to the
  377.              FAT as possible, FILL will not leave any free space between
  378.              files.    FILL  may  leave files fragmented around BAD disk
  379.              sectors and unmovable files.  This mode gives  you  all  of
  380.              the  benefits of that you get from other disk defragmenter,
  381.              but only takes a fraction of the time to run.
  382.  
  383.         FAST - mode will defragment all files and attempt to put them in
  384.              one  area  of disk space, FAST may leave gaps of free space
  385.              between files.
  386.  
  387.         QUICK - mode is like FAST mode but does not try as hard.
  388.  
  389.         DEFRAG - mode will defragment the files  on  the  drive  without
  390.              concern for there placement.
  391.  
  392.         The following modes will more than likely cause all of the files
  393.         and sub-directories on a disk to be moved.
  394.  
  395.         DATE - mode will put the files on the disk  oldest  files  first
  396.              (closest  to the FAT).  Using this mode once in a while, it
  397.              can take a long time to run, may  decrease  the  number  of
  398.              clusters  that  Disk  OrGanizer  will need to move with the
  399.              FAST or FILL mode.
  400.  
  401.         DIRECTORY - mode will put the files on the disk in the order  in
  402.              finds  them  in the directories.  That is the first file or
  403.              sub-directory in the root directory will be closest to  the
  404.              FAT (also refered to as LOW) followed by the second file in
  405.  
  406.  
  407.  
  408.      Disk OrGanizer                                                       5
  409.  
  410.      2. Using Disk OrGanizer
  411.      ----------------------------------------------------------------------
  412.      2.1. Modes
  413.  
  414.  
  415.              the root, etc.
  416.  
  417.         The following modes are for  compatibility  to  older  versions.
  418.         They are of little use.
  419.  
  420.         FRAGMENTED -  This  will  put  all  of  the  files that  are not
  421.              fragmented  on  the  disk  first  and  will  then  put  the
  422.              fragmented  files  on  the  disk.  Using this function will
  423.              slowly put all of the files that change size away from  the
  424.              FAT.  This mode does not work well if you have BAD clusters
  425.              or system files other than DOS on the disk.
  426.  
  427.         PACKED - This leaves the files in the same  order  as  it  finds
  428.              them on the disk, by cluster.
  429.  
  430.         2.2. Switches
  431.  
  432.         CRC - will cause Disk OrGanizer to read data after it is written
  433.              to the disk and test to  make  sure  that  it  was  written
  434.              correctly.
  435.  
  436.         BATCH -  tells  Disk  OrGanizer to suppress all prompts. This is
  437.              useful for running Disk OrGanizer from  a  batch  file.  If
  438.              this  switch  is set any error will cause Disk OrGanizer to
  439.              terminate.
  440.  
  441.         NOVERIFY - tells DOS not to verify data  written  to  the  disk.
  442.              (see  VERIFY  in  your  DOS  manual) This will increase the
  443.              speed of Disk OrGanizer but will allow  data  to  be  lost.
  444.              This switch should not be used on a floppy disk, but may be
  445.              used on a hard disk at your own risk.  This is  for  people
  446.              to  whom  speed  is more important than data integrity.  If
  447.              you have set the CRC switch then Disk Organizer will verify
  448.              the  data  and  you  can  include  this  switch  to improve
  449.              performance.
  450.  
  451.         2.3. Command line syntax
  452.  
  453.         The Command line syntax to  run  Disk  OrGanizer  from  the  DOS
  454.         prompt is:
  455.  
  456.              DOG [d:] [orderfile] [/commands] [/mode] [/switches]
  457.  
  458.         (The []'s mean optional and should not be typed.)
  459.  
  460.         d:  is  an optional drive specifier if no drive is specified the
  461.         current drive will be organized.
  462.  
  463.         Orderfile is the path and filename of the order file. If this is
  464.         not  included  Disk  OrGanizer  will  look  for  a  file  called
  465.         ORDER.DOG in the root directory of the drive being organized and
  466.         if  it  does  not  find that it will look in the environment for
  467.  
  468.  
  469.      Disk OrGanizer                                                       6
  470.  
  471.      2. Using Disk OrGanizer
  472.      ----------------------------------------------------------------------
  473.      2.3. Command line syntax
  474.  
  475.  
  476.         DOG=d:\path\filename and use that file.    If  no  orderfile  is
  477.         found  the DOS NUL device is used.  If you have an orderfile and
  478.         don't wish to use it you can tell Disk OrGanizer to use the  NUL
  479.         file as an orderfile (ie. DOG NUL /AUTO).
  480.  
  481.         Commands consist of AUTO and TRUNCATE.
  482.  
  483.         Mode tells Disk OrGanizer where to place the files on the drive.
  484.         You must  supply  a  mode  to  suppress  the  shareware  sign-on
  485.         message.  The  mode  can  be  set  on  the command line or in an
  486.         orderfile.
  487.  
  488.         Switches allow you to control several options  as  to  how  Disk
  489.         OrGanizer will test the data that is moved and interact with the
  490.         operator. Switches can be set on  the  command  line  or  in  an
  491.         orderfile.
  492.  
  493.         2.3.1. Command line commands
  494.  
  495.         TRUNCATE - tells Disk OrGanizer to truncate all sub-directories.
  496.  
  497.         AUTO -  tells  Disk  OrGanizer to put the directories defined in
  498.              the PATH environment variable first, followed by  the  file
  499.              definded  by  the COMSPEC environment variable, then all of
  500.              the other directories. If no other mode has been  specified
  501.              it  will  then  order the rest of the files as if the /FILL
  502.              mode was set.
  503.  
  504.         2.4. Orderfile syntax
  505.  
  506.         The orderfile can be used as a simple configuration file or  can
  507.         be  used to tell DOG the exact order that you would like to have
  508.         your files on a disk.
  509.  
  510.         Modes and switches that are  given  on  the  command  line  will
  511.         override those in the orderfile.
  512.  
  513.         You  may  find  it  more convenient to run Disk OrGanizer from a
  514.         batch file than to use the orderfile feature.    Again  I  would
  515.         like  to point out that the placement of files has little affect
  516.         on the speed at which they can be read.
  517.  
  518.         If you use the AUTO command line command you may not end up with
  519.         what you expected. (See listing 2.1)
  520.  
  521.         2.4.1. Setting the mode
  522.  
  523.         To  give  a mode in the order file enclose it in square brackets
  524.         ([]). A mode must be given on the command line or in  the  order
  525.         file  for  Disk OrGanizer to run. For a description of the modes
  526.         see above. A mode given on the command line  will  override  the
  527.         mode in the ORDER file.
  528.  
  529.  
  530.      Disk OrGanizer                                                       7
  531.  
  532.      2. Using Disk OrGanizer
  533.      ----------------------------------------------------------------------
  534.      2.4.2. Setting switches
  535.  
  536.  
  537.         ________________________________________________________________
  538.                    Listing 2-1: A very simple ORDER.DOG file
  539.  
  540.                ; The []s must be included.
  541.                [FILL]          ; set the mode
  542.                ; The AUTO command line command appends
  543.                [PATH]          ; these three orderfile commands
  544.                [COMSPEC]       ; to the end of the orderfile.
  545.                [ALLDIR]        ;
  546.                ;  And to truncate all of the directories
  547.                [TRUNCATE ALL]
  548.                ;
  549.  
  550.         ________________________________________________________________
  551.  
  552.         2.4.2. Setting switches
  553.  
  554.         Switches  can be specified in the orderfile by enclosing them in
  555.         square brackets ([]). (See the section on switches above.)
  556.  
  557.         2.4.3. Order file Commands
  558.  
  559.         The area of the disk close to the FAT is called the LOW area and
  560.         the  area  away  from the FAT is called the HIGH area.  Any file
  561.         that is not named anywhere in the  ORDER.DOG  file  is  said  to
  562.         FLOAT.
  563.  
  564.         In making this file you should name as few files as possible.
  565.  
  566.         The  following  three  commands  are  a  shorthand  for file and
  567.         directory names.
  568.  
  569.         PATH - is the same as listing all of the directories in the PATH
  570.              environment variable that are on the drive being organized.
  571.  
  572.         COMSPEC - The filename given in the COMSPEC environment variable
  573.              is used if it points to the drive being organized.
  574.  
  575.         ALLDIRECTORIES - Is the same as listing all of  the  directories
  576.              on the drive.
  577.  
  578.         The following commands tell where to place named files.
  579.  
  580.         LOW -  tells Disk OrGanizer to place the files described by fol-
  581.              lowing filenames close to the FAT.  This also  affects  the
  582.              FREE command. (see below)
  583.  
  584.         HIGH -  tells Disk OrGanizer to place files described by follow-
  585.              ing filenames away from the FAT.   This  also  affects  the
  586.              FREE command.
  587.  
  588.  
  589.  
  590.  
  591.      Disk OrGanizer                                                       8
  592.  
  593.      2. Using Disk OrGanizer
  594.      ----------------------------------------------------------------------
  595.      2.4.3. Order file Commands
  596.  
  597.  
  598.         ________________________________________________________________
  599.                        Listing 2-2: Sample ORDER.DOG file
  600.  
  601.            ;
  602.            [DEFRAGMENT]    ; if no mode is given on the command
  603.                            ; line use DEFRAGMENT
  604.            [FORCE]         ;
  605.            \COPYPRO.SYS    ; I don't want this file to move
  606.            [FLOAT]
  607.            [TRUNCATE]      ;
  608.            \DIR_A\         ; Truncate sub-directory DIR_A, but let
  609.                            ; it FLOAT.
  610.            ;
  611.            [LOW]           ; Set move files LOW.
  612.            \DOS\           ; Truncate sub-directory DOS, and put it
  613.                            ; next to the FAT.
  614.            [ENDTRUNCATE]
  615.            \COMMAND.COM    ; COMMAND.COM will be placed after \\DOS.
  616.            [FREE 500]      ; leave some room
  617.            ;
  618.            [HIGH]          ; set move files HIGH.
  619.            \AUTOEXEC.BAT   ; As this file is used only once, on
  620.                            ; reboot, we can move it away from the
  621.                            ; FAT.
  622.            \CONFIG.SYS     ; another seldom used file.
  623.            \ORDER.DOG      ; This file will be place just in front
  624.                            ; of CONFIG.SYS
  625.  
  626.         ________________________________________________________________
  627.  
  628.         FORCE -  tells Disk OrGanizer not to move the files that follow.
  629.              If you are going to FORCE file you should do it before  you
  630.              place files LOW or HIGH.
  631.  
  632.         FLOAT -  tells  Disk  OrGanizer to ignore the files that follow.
  633.              This is used if you wish to TRUNCATE  a  sub-directory  but
  634.              don't  want  to  put it LOW, HIGH or FORCE. NOTE: in future
  635.              releases this may be used this to allow SYSTEM files to  be
  636.              moved.
  637.  
  638.         These   commands  control  whether  named  directories  will  be
  639.         truncated.
  640.  
  641.         TRUNCATE -   sub-directories   named   between   TRUNCATE    and
  642.              ENDTRUNCATE  will have there size changed so that they will
  643.              use as little space as possible.
  644.  
  645.         ENDTRUNCATE - see TRUNCATE above.
  646.  
  647.         The following command will force clusters to be left free.
  648.  
  649.  
  650.  
  651.  
  652.      Disk OrGanizer                                                       9
  653.  
  654.      2. Using Disk OrGanizer
  655.      ----------------------------------------------------------------------
  656.      2.4.3. Order file Commands
  657.  
  658.  
  659.         FREE nnnn - tells  Disk  OrGanizer  to  leave  nnnn  (a  number)
  660.              clusters  of  free  space  after the last file named in the
  661.              order file if files are being placed LOW or before the file
  662.              if files are being placed HIGH. Disk OrGanizer ignores this
  663.              command if there isn't enough free disk space.    The  nnnn
  664.              may  be  replaced  with  an  asterisk  (*)  if you want all
  665.              available free clusters in a location.
  666.  
  667.         2.4.4. File identifiers
  668.  
  669.         A file identifier is a string that starts with a backslash  (\),
  670.         has  zero  or more sub-directory names, separated by backslashes
  671.         (the Path) and ends with a filename  or  sub-directory  name.  A
  672.         file identifier ending with a sub-directory name can be followed
  673.         by an optional backslash.
  674.  
  675.         It is important to understand that a  sub-directory  is  a  file
  676.         with  a  special  format  and  that  Disk  OrGanizer treats sub-
  677.         directories just like files in the orderfile  except  that  sub-
  678.         directories can be TRUNCATED.
  679.  
  680.         You  must  always  include  the  full  path  of  a  file or sub-
  681.         directory.
  682.  
  683.         Wildcards may be used in filenames.  But please  note  that  in-
  684.         cluding  a  large  number of files in the ORDER file can greatly
  685.         increase the amount of time it take Disk OrGanizer to organize a
  686.         disk.
  687.  
  688.         2.4.5. Comments
  689.  
  690.         A  comment  starts  with  a  semicolon  and ends with a carriage
  691.         return.
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.      Disk OrGanizer                                                      10
  714.  
  715.      3. Licensing and support.
  716.      ----------------------------------------------------------------------
  717.      3.1. Copyright/License/Warranty
  718.  
  719.  
  720.         3.1. Copyright/License/Warranty
  721.  
  722.         This document and the program files DOG.EXE ("the software") are
  723.         copyrighted  by the author.  The copyright owner hereby licenses
  724.         you to use the software given these restrictions:
  725.  
  726.          o  the program shall be supplied in  its  original,  unmodified
  727.             form, which includes this documentation;
  728.  
  729.          o  for-profit use without a license is prohibited;
  730.  
  731.          o  the  program  may  not be included - or bundled - with other
  732.             goods or services.  Exceptions may be granted  upon  written
  733.             request only.
  734.  
  735.          o  no fee is charged; an exception is granted to not for profit
  736.             user's groups, which are permitted to  charge  a  small  fee
  737.             (not  to  exceed  $5)  for materials, handling, postage, and
  738.             general overhead.  No other  organization  is  permitted  to
  739.             charge any amount for distribution of copies of the software
  740.             or documentation, or to include copies of  the  software  or
  741.             documentation with sales of their own products.
  742.  
  743.         There  is  no warranty of any kind.  The copyright owner may not
  744.         be held liable for any damages, including any  lost  profits  or
  745.         other  incidental or consequential damages arising out of or in-
  746.         ability to use the software.  By using the software,  you  agree
  747.         to this.
  748.  
  749.         3.2. Licensing
  750.  
  751.         No  license is required to run Disk OrGanizer on a computer that
  752.         is not used for business.
  753.  
  754.         The fee for a license depends on the estimated number of  copies
  755.         of  the program that you will use.  For local area networks, one
  756.         copy must be licensed for each computer that will be  using  the
  757.         program on the network.
  758.  
  759.         A license is not transferable.
  760.  
  761.                      Quantity     Price  Update
  762.                      ========     ==.==   ==.==
  763.                             1     30.00    6.00  each
  764.  
  765.                        2 to 9     25.00    5.00
  766.                      10 to 49     20.00    4.00
  767.                      50 to 99     15.00    3.00
  768.                    100 to 199     10.00    2.00
  769.  
  770.         Unlimited at one site  $2000.00  400.00
  771.              Additional sites   1000.00  200.00  unlimited at each site
  772.  
  773.  
  774.      Disk OrGanizer                                                      11
  775.  
  776.      3. Licensing and support.
  777.      ----------------------------------------------------------------------
  778.      3.2. Licensing
  779.  
  780.  
  781.  
  782.         The  price  to update to a new version applies only to the quan-
  783.         tity previously registered.
  784.  
  785.         Regardless of the quantity purchased you will receive  only  one
  786.         disk  and  one  printed manual. Additional manuals are available
  787.         for $6.00 each. You may make as many copies as are licensed  and
  788.         one archive copy.
  789.  
  790.         Orders of $50 or less must be prepaid. Orders over $50 - NET 30.
  791.  
  792.              Soft GAM's Software    SSN# 559-29-3621
  793.              (707)961-1470
  794.              P. O. Box 1311
  795.              Mendocino, CA  95460
  796.  
  797.         3.3. Technical Support
  798.  
  799.         Technical support is available to Disk OrGanizer supporters  and
  800.         licensed users. Limited support is also available to help you to
  801.         get Disk OrGanizer to operate on a computer,  so  that  you  can
  802.         evaluate it.
  803.  
  804.              CompuServe: PPN# 73210,3374
  805.  
  806.              the Bit Boutique BBS 707-778-8944, 2400 baud
  807.              Leave E-Mail to ALLEN MORRIS
  808.  
  809.              Mail : Soft GAM's Software, Box 1311, Mendocino, CA 95460
  810.  
  811.              Phone: (707)961-1632 (10 to 6 Pacific Time)
  812.  
  813.         3.4. ASP Ombudsman Information
  814.  
  815.         Disk  OrGanizer  is  produced  by a member of the Association of
  816.         Shareware Professionals (ASP).  ASP wants to make sure that  the
  817.         shareware principle works for you.  If you are unable to resolve
  818.         a shareware-related problem with an ASP member by contacting the
  819.         member  directly, ASP may be able to help. The ASP ombudsman can
  820.         help you resolve a dispute or problem with an  ASP  member,  but
  821.         does  not  provide  technical  support  for  members'  products.
  822.         Please write to the ASP Ombudsman at:
  823.  
  824.              ASP Ombudsman
  825.              545 Grover Road
  826.              Muskegon, MI 49442
  827.  
  828.         or send a CompuServe message via Easyplex electronic mail to the
  829.         ASP Ombudsman, CompuServe ID number 70475,1071.
  830.  
  831.  
  832.  
  833.  
  834.  
  835.      Disk OrGanizer                                                      12
  836.  
  837.      4. Error messages
  838.      ----------------------------------------------------------------------
  839.  
  840.  
  841.         The number in parentheses is the  ERRORLEVEL  returned  by  Disk
  842.         OrGanizer. If the error code is 100 or above, data may have been
  843.         lost on the disk.
  844.  
  845.         No Errors (0)
  846.              You are a happy camper.
  847.  
  848.         Terminated by user. (1)
  849.              The disk may still need to be organized.
  850.  
  851.         Illegal I/O redirection. (2)
  852.              Do not redirect output to the drive being organized.
  853.  
  854.         Order file is a device. (3)
  855.              The order file can't be read from a device, use a file.
  856.  
  857.         File not found. (4)
  858.              Check the filename you entered.
  859.  
  860.         Could not read/understand disk information. (5)
  861.              Please write or call and we can try to solve this problem.
  862.  
  863.         Error in order file. (6)
  864.              Fix or remove bad commands  or  filenames  from  the  order
  865.              file.
  866.  
  867.         Error on the command line. (7)
  868.              Check the syntax on the command line.
  869.  
  870.         Network drive. (8)
  871.              Reboot  your  computer without the network or don't publish
  872.              the drive you want to organize.
  873.  
  874.         Could not find directory for open file. (10)
  875.              Remove background programs or reboot the computer  and  try
  876.              again.
  877.  
  878.         Out of memory. (11)
  879.              Remove  TSR  programs,  increase  EMS memory or set the en-
  880.              vironment variable TEMP or DOGTEMP to a path  that  can  be
  881.              used for temporary storage.
  882.  
  883.         Error reading FAT. (I/O) (12)
  884.              Back up and reformat the disk or mark bad clusters bad.
  885.  
  886.         Possible NON DOS disk. (13)
  887.              The  disk  is an unknown type or the second FAT is bad. Run
  888.              chkdsk.  If you are still unable  to  run  Disk  OrGanizer,
  889.              Please call or write.
  890.  
  891.         Bad cluster in FAT. (14)
  892.              Run chkdsk.  If you are still unable to run Disk OrGanizer,
  893.  
  894.  
  895.  
  896.      Disk OrGanizer                                                      13
  897.  
  898.      4. Error messages
  899.      ----------------------------------------------------------------------
  900.  
  901.  
  902.              Please call or write.
  903.  
  904.         Error reading Directory (I/O) (15)
  905.              Back up and reformat the disk or mark bad clusters bad.
  906.  
  907.         Directory is corrupt. (16)
  908.              Run CHKDSK to repair the disk.
  909.  
  910.         Lost clusters found. (17)
  911.              Run CHKDSK to repair the disk or run Disk OrGanizer without
  912.              the BATCH or TEST switches set.
  913.  
  914.         You must have at least one free cluster. (18)
  915.              You should delete at least one file.
  916.  
  917.         Too many total files. (19)
  918.              Delete files from the disk until there are less that 32,752
  919.              files.
  920.  
  921.         Free clusters in FAT doesn't match DOS (21)
  922.              Remove any background programs that write to the disk.
  923.  
  924.         Too many File Fragments. (22)
  925.              Use  a mode other than FAST or FILL.  AUTO defaults to FAST
  926.              mode.
  927.  
  928.         No mode was given. (23)
  929.              You must supply a mode on the command line or in the  order
  930.              file.
  931.  
  932.         Incorrect DOS version. (42)
  933.              Reboot with DOS version 2 or greater.
  934.  
  935.         STDIN or STDERR redirected. (43)
  936.              Do not redirect the input or error output.
  937.  
  938.         Too many arguments. (44)
  939.              Remove some commands from the command line.
  940.  
  941.         Critical errors. (45)
  942.              Fix the problem that caused the critical error.
  943.  
  944.         INTERNAL ERROR @'code'. (90)
  945.              Please call and tell me the code that you received.
  946.  
  947.         I/O error moving clusters. Disk is OK. (99)
  948.              An  I/O  error  was  detected.   You should run a disk test
  949.              program on the disk or back up the disk,  reformat  it  and
  950.              restore the data.  No data was lost and the disk is in good
  951.              repair.
  952.  
  953.         I/O error moving clusters. Data may have been lost. (100)
  954.              An I/O error was detected. You should run a disk test  pro-
  955.  
  956.  
  957.      Disk OrGanizer                                                      14
  958.  
  959.      4. Error messages
  960.      ----------------------------------------------------------------------
  961.  
  962.  
  963.              gram on the disk or back up the disk, reformat it  and  re-
  964.              store the data.  There may be errors on the disk.
  965.  
  966.         I/O error Packing (101)
  967.              There  was  an  error Packing a directory. You should run a
  968.              disk test program on the disk or back up the disk, reformat
  969.              it and restore the data.  There may be errors on the disk.
  970.  
  971.         Critical errors. (102)
  972.              Fix  the  problem that caused the critical error. There may
  973.              be errors on the disk.
  974.  
  975.         INTERNAL ERROR @'code'. (200)
  976.              Please call and tell me the code that you got. There may be
  977.              errors on the disk.
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.      Disk OrGanizer                                                      15
  1019.  
  1020.      5. Glossary
  1021.      ----------------------------------------------------------------------
  1022.  
  1023.  
  1024.  
  1025.         CHKDSK - A  program  that  came  with  DOS.  Its  full  name  is
  1026.         CHKDSK.COM. See your DOS manual for more information.
  1027.  
  1028.         Cluster - DOS stores data in cluster units. Clusters are made of
  1029.         one or more sectors.
  1030.  
  1031.         FAT - The File Allocation Table.
  1032.  
  1033.         File Allocation Table - This along with the directories tell DOS
  1034.         where to find a file on the disk.
  1035.  
  1036.         Hidden  file  -  A  file with the hidden attribute bit set. Disk
  1037.         OrGanizer will move these files.
  1038.  
  1039.         Hidden directory - A directory with  the  hidden  attribute  bit
  1040.         set. Disk OrGanizer will move these directories.
  1041.  
  1042.         Lost clusters - Clusters that are mark in the FAT as being used,
  1043.         but have no directory entry that points to them.
  1044.  
  1045.         Null file - A file with no data in it.
  1046.  
  1047.         Sector - The smallest unit that data can be stored on a disk.
  1048.  
  1049.         System file - A file with the system  attribute  bit  set.  Disk
  1050.         OrGanizer will not move these files.
  1051.  
  1052.         System  directory  -  A  directory with the system attribute bit
  1053.         set.  Disk OrGanizer will not move these directories.
  1054.  
  1055.         User file - A file that does not have the system or  hidden  at-
  1056.         tribute bits set. Disk OrGanizer will move these files.
  1057.  
  1058.         User  directory  -  A directory that does not have the system or
  1059.         hidden attribute  bits  set.  Disk  OrGanizer  will  move  these
  1060.         directories.
  1061.  
  1062.         Volume label - A special file that tells DOS the name of a disk.
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.      Disk OrGanizer                                                      16
  1080.  
  1081.      6. Index
  1082.      ----------------------------------------------------------------------
  1083.  
  1084.  
  1085.         Aborting from DOG  4           Order file Commands (Cont.)
  1086.         ALLDIRECTORIES  8                 FORCE  8
  1087.         AUTO  7                           FREE nnnn  9
  1088.         BATCH  6                          HIGH  8
  1089.         CHKDSK  3, 16                     LOW  8
  1090.         Cluster  16                       PATH  8
  1091.         Command line commands             TRUNCATE  9
  1092.            AUTO  7                     orderfile  6
  1093.            TRUNCATE  7                 PACKED  6
  1094.         COMSPEC  7, 8                  PATH  7, 8
  1095.         Copy protected programs  3     QUICK  5
  1096.         CRC  6                         Sector  16
  1097.         current drive  6               Switches
  1098.         DATE  5                           BATCH  6
  1099.         DEFRAG  5                         CRC  6
  1100.         DIRECTORY  5                      NOVERIFY  6
  1101.         drive specifier  6             System directory  16
  1102.         ENDTRUNCATE  9                 System file  16
  1103.         environment                    Technical Support  12
  1104.            COMSPEC  7                  TRUNCATE  7, 9
  1105.            PATH  7                     User directory  16
  1106.         FAST  5                        User file  16
  1107.         FASTOPEN  2
  1108.         FAT  16
  1109.         File Allocation Table  16
  1110.         FILL  5
  1111.         FLOAT  9
  1112.         FORCE  8
  1113.         FRAGMENTED  6
  1114.         FREE nnnn  9
  1115.         Hidden directory  16
  1116.         Hidden file  16
  1117.         HIGH  8
  1118.         Lost clusters  16
  1119.         LOW  8
  1120.         Modes
  1121.            DATE  5
  1122.            DEFRAG  5
  1123.            DIRECTORY  5
  1124.            FAST  5
  1125.            FILL  5
  1126.            FRAGMENTED  6
  1127.            PACKED  6
  1128.            QUICK  5
  1129.         NOVERIFY  6
  1130.         NUL device  7
  1131.         Null file  16
  1132.         Open files  2
  1133.         Order file Commands
  1134.            ALLDIRECTORIES  8
  1135.            COMSPEC  8
  1136.            ENDTRUNCATE  9
  1137.            FLOAT  9
  1138.  
  1139.  
  1140.      Disk OrGanizer                                                      17
  1141.  
  1142.